Beratung des Assemblers 28AS39 tersiun 3-03 


1.Binfuehrung 

Der PLZ/ASM-Assembler ZÖASH uebersetzt einen (mit Bditor erzeugten) 
Quellfile in ein Qbjektmodule und ein Listingmodule. Der Assembler 
laeuft unter dem Betriebssystem UDOS, Der Objektmodul kann absolut 
oder relativ ladbar erzeugt werden. Die Steuerung des Uebersetzungs- 
prozesses kann mit den Assemblerdirektiven erfolgen. 


2.Asbembleraufruf 

Z8ASM filenamel [Optionen] 


filenamel Quellfile,muss die Erweiterung ".S" haben* Wenn 

".S" im Aufruf fehlt, Wird es vom Assemblerselbst- 
staendig ange haengt. 

optinen Dienen der Konkretisierung des Aufrufs, Sie stehen 

nioht in Klammern und sind wahlfrei I 


D*zeiohenkette 
I*filename2 
1-filename3 


NOL 


"zeichenkette" max. 18 Zeichen fuer Kopfzeile im 
Listing. 

Zwischendatei wird nicht geloescht und untej; "fi- 
lename2" abgelegt. 

Das Listingfile' wird unter "filoname3 M abgelegt; 
sonst: "filenamel.L" 

Es wird kein Listingfile erzeugt. 


Ö=filename4 Der Objektfile wird unter "filenameV 1 abgelegt; 
sonst: "filenamel.OBJ 


OenNULL 


Es wird kein Objektfile erzeugt. 


P Eine Kopie des Listingfiles wird ueber d,logische 

Einheit "SYSLIST" (z.B.Druoker) ausgegeben. 

Beispiele: Z8ASM TEST.S NOL 

Es wird TEST.OBJ erzeugt. 


Z8ASM TES.T 0=bNÜLL D=Meier-S oft wäre 

Es wird TEST.L mit Kopftext "Meier-Software" er¬ 
zeugt • 
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3 .Listlngformat 

Der Kopf der 1.Seite enthaelt die Asm.-Versionsnr. und optional die 
"D-Zeichenkette” sowie folgende Spaltenbezeichnungen: 

LOC/OBJ CQDE/STMT/SOURCE STATEMENT 

IOC rel.Speicherplatzadr. und Sp.-bereiehsbezeiohner: 

P = PROGRAM 
D * DATA 
. R = REGISTER 

OBJ CODE erzeugter Ob^ektcode und Polgezeichen: 

Cspace) ..endgueltiger Code 

(') ... relativer Wert 

(*) ... Wert abhaenig von EXTERNAL 

(...) vorheriges Byte o.Word wird wiederholt 

STMT Qellzeilennummer 


SOURCE STATEMENT 


Qellzeilentext 



1 .Schluesselwoerter nraessen vollstaendig aus Gross.-oder Kleinbuch¬ 
staben bestehen,z.B.: GLOBAL oder global ; falsch: Global. 

2. Kommentare und Zeichenketten koennen ueber mehr als eine Zeile 
verteilt sein. Zeichenketten der Laenge 0 (zJB.: 1 *) sind unSulaes- 
sig. Namen koennen aus max. 127 Zeichen bestehen. 

3. Bei Konstantendefinitionen werden nur die 1. vier Zeichen be¬ 
nutzt, z.B.: 'KONST' = 'K0NS1* ! Konstanten werden intern als 
vorzeichenlose 32-bit-Worte dargestellt, z.B.: 4/-2 =0 ,da -2 als 
sehr grosse vz.lose Zahl dargestellt wird. 

4. Die Initialisierungssymbole "..."und geschachtelte eck.Klam¬ 
mern ('['und']') sind nicht implementiert. 

5. Nach einem Fehler in Const.-, Typ- oder Variablenvereinbarungen 
springt der Assembler, zum naechsten Schluesselwort, wodurch ev. 
nicht alle Fehler aufgeweckt werden. 
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anhang-a 

i.Asgembleräirektiven 


Die Assemblerdirektiven muessen allein auf einer Zeile stehen, Kommen¬ 
tar kann jedoch gegeben werden. Die Direktiven erscheinen bis auf 
nPAGE^explizit im Listing* 


nSBCTION [sjiame] section Der folgende Objektcode wird dem Speicher¬ 
bereich section zugeordnet (section:= 
DATA/PROGRAM/REG ISTER) •Hit s_name koen- 
nen weitere Bereiche definiert werden. 


nSDEFAUXiT 


nABS [adresse] 
nREL [adresse] 


nPAGB 

nLISTOFF [option] 
nLISTON [option] 

Optionen: nTTY 


nBEX 

■ \ 


Stellt Standart-Speicherzuweisung her: 

V ariablenve reinb. REGISTER-S e ction 

Procedurvereinb. PROGRAM -Section 

Der folgende Objektcode wird beginnend mit 
"adresse” absolut uebersetzt. 

Der folgende Objektcode wird relativ (ver¬ 
schieblich) uebersetzt. Ist "adresse" 
angegeben, ist sie eine rel. Distanz zum 
Anfang des Moduls. 

Seitenvorschub im Listing. 

Ohne Option schalten sie das listing aus 
und ein. Standart: nLISTON 

Erzeugt 80-spaltiges Listingformat. 
Standart ist nLISTOFF nTTY, d.h. volle 
Zeilenlaenge. 

nLISTOFF nßEX listet nur eine Objektcode¬ 
zeile fuer eine Qellcodezeile auf. S.tan- 
dart ist nLISTON nBEX, d.h. der ges. 
Objectcode wird aüfgellstet. 


2♦Pseudobefehle 


SVAL ausdruck Ein Bytewert wird definiert und in den. 

Objekt code eingefuegt* 

WVAL ausdruck Es wird ein Wort (2Byte) definiert u.in 

den Objektcode eingefuegt. 


3 



des ÜiBsblers SBMSS. Tersion 3-Ö3 


ANHANG—B 


Ass embler-Fehl ermeldungen 
Fehler Bedeutung 
Warnungen 

0 Ein n -" oder "+" als Binaeroperator behandelt 

1 Fehlendes Trennzeichen 

2 Array enthaelt kein Element 

3 Record enthaelt kein Feld 

4 Unpassender Procedurname 

5 Unpassender Modulname. 

6 Konstante ausserhalb des Typbereiche 

7 Unzulaessige Adress-Polnterwandlung 


Zeichenfehler 


10 

Dezimalzahl zu gross 

11 

Unzulaessiger Operator 

12 

Unzulaessiges Zeichen nach % 

13 

Unzulaessige HexadezimalZiffer 

14 

Zeichenkette der laenge 0 

15 

Unzulaessiges Zeichen 

16 

Hexadezimalzahl zu gross 


D 0-S c hl e i f en-Pe h 1 er 

20 

Unangepasstes "OB" 

21 

"0D" erwartet 

22 

Unzulaessige REPEAT-Anweisung 

23 

Unzulaessige EX IT-Anweisung 

24 

Unzulaessige FROM-Marke 


IF-Anweisung-Fehler 

30 

Unangepasstes "FI" 

31 

W FI" erwartet 

32 

«THEN 1 * oder "CASE" erwartet 

33 

Unzulaessiges Selektorregister 


Erwartete Symbole 

40 

n)n erwartet 

41 

"(" erwartet 

42 

"]” erwartet 

43 

"t" erwartet 

44 

erwartet 

45 

,, < w erwartet 


Nichtdefinierte Namen 

50 

Nichtdefinierter Name 

51 

Nichtdefinierter Procedurname 
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60 

61 

62 

63 

64 
63 
66 

67 

68 


70 

71 

72 

73 

74 


80 

81 

82 

83 


90 

91 

92 

93 

94 

95 

97 

98 

99 


101 

102 

103 

104 

105 


110 

111 

112 

113 

114 

115 


Vereinbarungsfehler 
Typname erwartet 
Unzulaessige ModulVereinbarung 
Unzulaessige Vereinbarungsklasse 
Unzulaessige Verwendung von ARRAY [*] 

ARRAY [*] ohne Initialisierung 
Unzulaessige Dimensionsgroesse 
Unzulaessiger Komponententyp eines Array 
Unzulaessige RE.C’ORD-Feld-Vereinbarung 
Unzulaessiger Typ bei Pointervereinbarung 

Procedurvereinbarungsfehler 
Unzulaessige Procedurvereinbärung 
"ENTRY" erwartet 

Procedurname nach "END" erwartet 
Formaler Parametername erwartet» 

Unzulaessiger Typ eines formalen Parameternamens 

Initial!sierungsfehler 
Unzulaessiger Anfangswert 
Zu viele Initialisierungselemente 
Unzulaessige Initialisierung 
Falsche ARRAY [*] -Initialisierung 

Spezielle Fehler 
Unzulaessige Anweisung 
Unzulaessiger Befehl 
Unzulaessiger Operand 
Operand zu gross 

Relativadresse ausserhalb des Bereiches 
erwartet 

RECORD-Feldname doppelt 
CASE-Konstante doppelt 
Mehrfache Namensver e'inbarung 

Variablenfehler 
Unzulaessige Variable 

Unzulaessiger Operand fuer T, # M oder "SIZE0F" 
Unzulaessiger Feldname 

Indizierung einer Nicht-ARRAY-Variablen 
Unzulaessige Verwendung von 
.Unzulaessige Verwendung von "<" 

Fehler in Ausdruecken 
Unzulaessiger arithmetischer Ausdruck 
n bedingter Ausdruck 

", konstanter Ausdruck 

" Auswahlausdrück 

" Indexausdruck 

Ausdruck in einer Zuordnung 
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Konstantenfehler 

120 Konstante zu gross fuer 1Byte 

121 Konstante zu gross fuer 2 Byte 

122 Konstanter ARRAY-Index ausserhalb der Grenzen 

Typ-Kompatibilitaet 

140 ARRAY [*]-Initialisierung mit Typ ungleich 8 Bit 

141 Typ-Inkompatibilitaet bei Initialisierung 

Segmentierungsfehler 

170 Unzulaessiger Operator im nichtsegmentierten Modus 

171 Unpassender Adressoperator 

172 Unpassender Segmentbeseichner 

Direktiven-Pehier 

180 Fälsche Sectionsspezifieierung 

181 Unzulaessige Sectionszuordnung 

182 Unpassende bedingte Assemblierung 

183 Unzulaessiger Ausdruck bei bedingter Assemblierung 

184 Versuch,segmentierten und nichtsegm, Code zu mischen 

185 Direktive nicht allein auf eii*er Zeile 

File-Fehler 
1 96 EOF erwartet 

199 Unerwartetes EOF in Quelle (”1" oder unpassend ?!) 

Implementierungs einschraenkungen 

229 Merkmal nicht implementiert 

230 Seichenkette oder Name zu lang 

231 Ueberlauf der Symboltabelle 

232 Procedur .zu gross 

233 Linke Seite einer Ergibtanweisung zu kompliziert 

234 Su viele InitialisifeTungswerte 

235 Compiler-Stack-Ueberlauf 

236 Operand zu kompliziert, zu viele Konstanten im Ausdruck 

237 Ueberlauf der statischen Daten 

238 Progranmbereich-Ueberlauf 

239 Zu viele INTERNAL- oder GLOBAL-Procedure 

240 M Laenge"-Konstante nicht implementiert 
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ZLDfK bindet seperat asserablierte Moduln, # wobei externe Referenzen 
aufgeloest werden. Wahlweise kann eine 'Linkmap* erzeugt werden mit 
Informationen ueber Anordnung und Laenge von Sektionen und Moduln. 
Weiterhin erfolgt eine Fehlerausgabe. 

Die Eingabemoduln muessen stets relativ assembliert sein! Der eben¬ 
falls relative Lademodul kann- erneut inkremental gebunden werden. 


2.Linkeraufruf 

ZLUtK kommando zeile 

kominandozeile öbjektfiles [Sektionen] [optionen] 

objektfiles Namen der zu bindenden Objektfiles. Sie muessen 

die Erweiterung ".OBJ" haben, die aber in der 
Kominandozeile weggelassen werden kann. 

Sektionen Sektionen koennen mit Klammern logisch zusammen¬ 

gefasst und mit Namen versehen werden. z,3.: 
(A_DATA B__DATA CJDATA) 

werden unter dem* Namen A DATA zuaammengef asst 
ALLEJDATA = (A__DATA B_DATA C_DATA) bzw. 

ALLE_DATA * (*DATA) 

werden unter dem Namen ALLE_DATA ...zusaramengef asst 
Achtung: Es koennen nur Sektionen gleichen Typs verbunden 

werden! 

Optionen ... Optionen sind wahlfrei. 

L = filename/* Linkmap wird unter filename bzw;(bei *) unter 1. 

Objektfiienamen.MAP abgelegt. Ohne Option L wird 
keine Linkmap erzeugt. 

N = filename/* Der Lademodul wird unter filename abgelegt. Stan¬ 
dart ist 1 .Objektfilenamen ohne ''.OBJ” 

T = filename/* Wie Option L, aber fuer Zwischenfiie. 

E ’• name Es wird ein Procedumame o.-Marke als Eintritts¬ 
punkt festgelegt. Standart ist das 1. ENTRY-Sym-** 
bol. 

W = ON/OFF Fehlermeldungen der Klasse III werden nur bei 
v W*ON gemacht. Standart ist W=OFF. 

K = }namenliste{ Beim inkrementalen Binden erst spaeter ver- 

fuegbare Symbole muessen in der namenliste ste¬ 
hen.. 

K~- ALL y Alle globalen Symbole sind im Lademodul enthalten* 
K = NONE Lademodule enth.keine globalen Symbole (Standart). 

K = ALLBWT }namenllste{ 

Der Lademodul enthaelt globale Symbole, bis auf 
die Symbole der namenliste. 
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ANHANG-C 


Linker-Fehlermeldungen 

1»Fehlerklasse I:Unmittelbarer Abbruch des Linker 

ILLEGAL CHAR IN COMMAND LINE <c> 

Die Kommandozeile enthaelt das vom Lin¬ 
ker nicht deutbare Zeichen <c>. 

ERROR IN'GROUP ING FORMAT: <symbol> 

Lurch Symbol bewirkter Fehler bei Grup- 
penbildung. 

OPTION NOT RECOGNIZED IN COMMANL LINE: <c> 

Nichtzulaessige Option c. 

NAME EXCEELS MAXIMUM <name> 

Filenname zu läng. 

UNABLE TO OPEN TEMPORÄR! FILE: <name> 

Der Zwischenfile name kann nicht eroeff- 
net werden. 

UNABLE TO OPEN OBJECT FILE: <name> 

Der Objektfile name kann nicht eroeffnet 
werden. 

UNABLE TO OPEN INPUT FUE: <name> 

Der Eing.file name kann n.eroeff.werden. 

UNABLE TÖ OPEN LINK MAPFILE: <name> - 

D.Linkmapfile name kann n.eroeff.werden. 

WRITE FILE ERROR, ERR CODE: <hexsahl> 

Systemfehler b.Fileschreiben. 

READ FILE ERROR, ERR CODE:* <hexzahl> 

Systemfehler b.Filelesen u.Anz. F.-kode. 

SEEK ERROR, ERR CODE: <hexzahl> 

Fehler b.Suchen einer Position im File. 
Anzeige Fehlerkode. 

UNABLE TO CLOSE FILE: <name>, ERR CODE: <hexzahl> 

Fehler beim Sohliessen des Files name. 
Anzeige Fehlerkode. 

SYMBOL TABLE OVERFLOW Symboltabelle ist voll, (abhaeng. von 

Anzahl u.Laenge der globalen Symbole. 

GENERAL TABLE OVERFLOW Der fuer allg.Info. vorgesehene Platz 

ist voll. (abhaengig von Anzahl der Sek¬ 
tionen in den. Moduln. 

BAD CALL TO ERROR ROUTINE: <err> 

Die interne Linkerfehlerroutine kann 
einen Fehler nicht deuten. 

FEATURE NOT IMPLEMENTED: <c> 

Die Kommandozeile enthaelt eine noch 
nicht implementierte Optien c. 
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2.rehlerklasse IltLinkerabbruch nach 1»Pass 


MULTIPLE DECLARATION OF GLOBAL: <name> <module1> <module2> 

Ein in modulel definierter globaler Na¬ 
me ist schon in module2 definiert. 

SEG AND NONSEG MODÜLES, fl IXED 

Segmentierte und nichtsegmentierte Mo— 
dule treffen zusammen. 

OBJECT CODE CONTAINS ERROR: <name> <fehler> 

Der Objektkode im File 1 name ist fehler¬ 
haft, fehler = Fehlerkode. 

BYTE OVBRFLOV Ein re 1.Bytewert ist zii gross f.8 Bit. 


SECTION T00 LARGE: <name> 
INPUT POSSIBLY Z80 CODE 
SEG TAG IN NONSEG MODULE 


Die Groesse der Sektion name uebersteigt 
65 536 Bytes. 

Eingabefile nicht deutbar, eventuell 
Z80-0b j ektmodule. 

Eine auf segm.Modul hinweisende Groesse 
ist in einem nichtseg.Modul gef. worden. 


3.Fehlerklasse III:¥arnungsmeldungen 

GLOBAL TYPE HISMATCH: <name> <module1> <raodule2> 

Typunterschied von name in modulel und 
module2, 

UNDEFINED GLOBAL: <name> <module> 

In module ist ein Bezug zum nichtdef. 
glob.Symbol name vorhanden. 

NO ENTRY POINT FOUND Kein Eintrittpunkt im-Modul gefunden. 

UNMATCHED SECTION ATTRIBUTES 

Der Linker soll Sektionen verschiedenen 
Typs kombinieren,.z.B. REGISTER mit DATA. 
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Die mit Assembler oder Linker erzeugten relativen Objektmodule 
werden durch den IMAGER zu einem einzigen File im absoluten Kode 
verarbeitet. Der File kann optional auf Diskette abgelegt Werden. 
Die max. laenge betraeg^ 8000H Bytes. 


2.IMÄSER-Aufruf 

IMAGER fileliste (sectionsÜBte) {fenster} Optionen 

fileliste Liste der zu verarbeitenden Objektmodule. Die 

Filenamen mueesen vollstaendig angegeben werden! 

sectionsliste Informationen ueber Speicherplatz und Reihenfolge 
des Kodes der Objektmodule.' Jedem auf gef uehrten t 
Sektionsname geht die Angabe des LadeapfangsPunk¬ 
tes voraus: 

H^hexa sname 

Die Anfangsadressen in der Sectionsliste mueesen 
aufsteigend sein. Nichtaufgefuehrte snamen werden 
standartmaess.in der zuletzt aufgefuehrten Section 
plaziert. Nichtzuladende snamen sind expliziet mit 
einem Minuszeichen zu versehen. 

fenster {anfhexa endhexa}: Anf.-u.Endadr.des verfuegbaren 

Speicherplatzes.(Low-u.Highadress des Files) 

Optionen O-filename Es wird ein File ‘filename* erzeugt. 

E=hexa Setzen des Bintrittspunktes auf hexa 

Standart (Ohne E): anfhexa 

Beispiele: * IMAGER LI.OBJ (n=4 REGISTER n=800 PROGRAM n=1Q00 
DATA) (800 1000} E=812 0=LI.P 

-Registervereinbarungen gelten ab Reg.4 
-Programmeode wird ab 8Ö0H bis max.lOOOH abgelegt 
-Datenvereinbarungen gelten ab Adr.lOOOH 
-Es wird der File , LT*P t erzeugt 

* IMAGER HAUPT.OBJ INTR (a=0 PROGRAM n-1000 DATA 
n=3000 DTTJATA) (0 800} E*C 0=TIMER 

-Programmcode wird ab 0H bis max.ÖOOH abgelegt 
-Datenvereinb.gilt ab Speicherpl.1000H 
-Anwendersektion INT_DATA gilt ab Speicherpl.3000H 
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ANHANG-D 

IMAGER-Fehlermeldungen 


UNABLE TO OPEN INPUT 


Eingabeobjektfile laesst sic h nicht 
eroeffnen. 


ILLEGAL TAG-ENCOUNTER IN PUB: <name> 

Der Objektmodul 'name' enthaelt 
fehlerhaften Objektkode. 


ILLEGAL MODULS IN FILE; <name> 

SECTION ERROR IN FILE; <name> 


Fehlerhafte Moduldefinition im Ob¬ 
jektfile Vname 1 . 

Fehlerhafte Sektionsdefinition im 
File *name 1 . 


ILLEGAL COMMAND LINE Syntaxfehler in der Kommandozeile. 

SYMBOL TABLE OVERFLOW Zu viele Symbole. 

SEGMENT3D AND NONSEGMENTED MODULES MAY NOT BE' COMBINED 

Versuch, segm. u. nichtsegm. Kode 
zu laden. 


UNEXPECTED EOF ENCOUNTBRED IN FILE; <narae> 

Der ObjektCode enthaelt fehlerhafte 


EOF-Marke. 


UNABLE TO OPEN PROCEDURE FILE 

PROCBDURE FILE INVALID 
UNABLE TO CLOSE PROCEDURE FILE 


Procedurfile kann nicht eroeffnet 
werden. 

Procedurfile nicht richtig erzeugt. 

Procedurfile kann nicht abgeschlos^ 
sen werden. 


MESSAGE NOT FOUND Objektfile mit fehlenden Informa¬ 

tionen (alte Assemblerversion). 

POSSIBLB CODE OVERLAY IN SEGMENT <num> AT LOCATION <number> 

number in num wurde mehr als einmal 
geladen (Kodeueberlagerung) 

UNRESOLVED EXTBRNAL REFERENCE IN <name> 

Eingabeobjekt 'name* enthaelt einen 
Bezug auf eine undef. ext.. Groesse. 
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